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CONVENTIONS AND GUIDELINES FOR CDCNET COMMANDS 
1.0 INTRODUCTION 



1.0 laiiQaUCIIQE! 




This document addresses the subject of conventions and guidelines for 
the CDCNET commands. It consists of three sections. The first section 
describes the specific conventions and guidelines for the CDCNET 
commands. The second section identifies the major groups in which the 
CDCNET commands may be divided. This section also includes the names of 
objects* verbs and commands in each group and their purpose. The third 
section lists the changes to be made in the existing CDCNET commands so 
that they follow the proposed conventions and guidelines. This section 
also describes the reasons for these changes as well as provides a 
summary of the new names for the CDCNET commands* their verbs and 
objects. 

The conventions and guidelines for the CDCNET commands are being 
established to meet the following objectives. 

• The CDCNET commands should be easy to learn and easy to use. This 
should be accomplished by making commands and their parameter 
names as well as their use as consistent as possible. 

• All CDCNET commands should be consistent with NOS/VE commands as 
much as possible. To achieve this* the CDCNET command conventions 
should be compatible with the NOS/VE command conventions. 

. The rules to obtain abbreviated names for command and parameter 
names should be well defined with absolutely no deviations or 
exceptions. It should be always possible to derive the 
abbreviated name of a command from its full name by following the 
same rules every time. 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 
2 . CQCfcl£I-£QIUlAlUL.£QIl)£EllIlDtlS-AIiQ-aUin£J.IllES 



A command is identified via its name. It is specified in terms of its 
name* a list of its parameters* relative position of these parameters 
within the command and the explicit value or type (e.g. integer) of 
value which may be specified for each parameter. The following are some 
general conventions. Subsequent sections provide specific conventions 
for command and parameter names and rules for their abbreviation. 



1) 



All CDCNET commands should follow the NOS/VE SCL syntax. 



2) The value of a command parameter should not be used to 
indicate the function to be performed by the command. 

3) Within a single command every effort should be made to 
minimize the illegal combinations of values of two or more 
parameters. This will happen if command parm.eters are not 
orthogonal. In some cases this type of situation may be 
avoided by defining a new parameter in place of the parameters 
which are not orthogonal and therefore can have values which 
conflict with each other. 

4) Whenever possible* a single command should be defined to 
perform the same function on one or more elements of the same 
type. For example the same command ( "DISPLAY_NETWORK_STATUS ) 
should be defined to display the status of all network 
solutions instead of separate commands ( like 
M DISPLAY_HDLCNETWORK..STATUS") to display the status of each 
supported network solution. However* this convention should 
not be followed if its use violates the convention number 2* 
described above. 

5) If a command can perform a function on one or more elements* 
and this can be indicated by using a singular or plural word 
In the command name* then such a command should be allowed to 
be known by two names. The only difference in the two names 
will be the use of singular or plural word. For example 
consider the command used to display the configured attributes 
of a terminal. If this command is designed in such a way that 
its user can specify ( via a parameter) which configured 
attributes are to be displayed* then this command should be 
specified via the following two names. 

DISPLAY.TERMINAL.ATTRIBUTE 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 



DISPLAY_TERMINAL_ ATTRIBUTES 

Both of these command names will have the same abbreviation 

(I.e. DISTA) and the user will be free to use either of these 

commands or their abbreviation to display one or more 
attributes of the terminal. 



2.1 tattttAafl-UAHE-CQHYEllIiaHS 



The following conventions and guidelines should be followed in 
selecting command names. 

1) Each command name should consist of at least one and 
optionally up to two parts. The first part called the command 
verb should be a verb describing the operation -performed by 
the command. It should be represented by a single word. This 
word should always be the first word in the command name. 
Each command name must include the command verb. part. 



The second part called the command object should specify the 
object which is the target of the operation to be performed by 
the command verb. The command object will be always specified 
via an object name. Optionally it may also include an object 
qualifier. If present* the object qualifier will always 
precede the object name within the command name. All words in 
a command name will be concatenated with the under score(_) 
character. To illustrate the various parts of a command name 
consider the following examples. 

DEFINE. HDLC.TRUNK 

DISPLAY.SYSTEM.STATUS 

START.DIRECTORY 

In the first command* •'DEFINE'* is the command verb and 
"HDLC_TRUNK" is the command object. Within this command 
object, "TRUNK" is the object name and "HDLC" is the object 
qualifier. In the second example "DISPLAY" is the command 
verb, "SYSTEM" is the object qualifier and "STATUS" is the 
object name. In the third command "START" is the command verb 
and "DIRECTORY" is the command object. In this case there is 
no object qual i f ier. 

2) In specifying command names, the words used for object and 
object qualifier may be interchanged freely to make commands 
more meaningful or attractive to the human user. In other 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 

2.1 COMMAND NAME CONVENTIONS V 

words It Is okay to use the object qualifier in one command as 
the object name in another command* as long as the commands 
are more meaningful or attractive to the human user. For 
example consider the following two commands. 

DISPLAY.LINE. STATUS 
STARTJ.INE 

In this example the word "LINE" is used as the object 
qualifier in the first command and as the object name in the 
second command. 

3) The command names should be specified such that the same verb 
is used for same or similar functions. For example* it is 
possible to use the verbs DISPLAY* SHOW and LIST to display 
different attributes (e.g. status) of a CDCNET component. 
However* the command conventions will require selection and 
use of only one of these verbs. 

4) If two commands provide opposite functions* then the verbs 
used in the two commands should be semantic opposites of each 
other. Some examples of semantically opposite verbs are: 

START AND STOP V 

DEFINE AND CANCEL 
LOAD AND UNLOAD 

5) The following rules will be used to determine the abbreviation 
for a command name. 

. Abbreviation for a command name will be generated by 
taking the first three characters of the command verb 
and concatenating it with first character of each word 
following the command verb in the command name. For 
example the abbreviation for the "DISPLAY.LINE.STATUS" 
command will be "DISLS 1 *. 

• If the command verb contains less than three characters* 
then an abbreviation will not be defined for the 

command. 

. If the names of two or more commands are such that they 
result in the same abbreviation* then one or more of 
these names will be changed so that the use of the above 
rules to determine abbreviations will result in unique 
abbreviations for all commands. 

6) Names of all CDCNET commands will be equal to or less than 30 
characters. This is a deviation from the NOS/VE command < ^ 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 

2.1 COMMAND NAME CONVENTIONS 



convent i ons* 
characters. 



which allows a command name to contain up to 31 
This deviation is due to the following reason. 



31 

to 



The internal name of any CDCNET command may be up to 
characters long. However* each command name is required 
contain one special character f$)> so that the associated 
entry point can be d i stt ngui sged from non-command ( processor 
) entry points. This requirement has been put in place to 
prevent an attempt to execute any user ' 
string as a command. NOS/VE 
because of its command list feature. 



does 



typed in character 
not have this problem 



The names of all parameters of CDCNET commands should be specified 
using the following conventions. 



o 



1) A parameter name will consist of one or more words 
concatenated with the underscore (_) character. 

2) If same parameter is used in more than one command then the 
same name will be used for this parameter in all commands. 

3) If similar parameters are used in more than one command then 
the same name will be used for such parameters in ail 
commands* unless the names are used to convey the differences 
in the similar parameters. 

4) The size of a parameter name for any CDCNET command will not 
exceed 31 characters. 



5) 



6) 



A parameter name will be abbreviated by using the first 
character of each word in the parameter name. For example the 
abbreviation for the parameter name "LINE_SPEED M will be "LS". 



For a given command* the names of ail 
selected so that no two names will 
abbrevi at i on. 



parameters will be 
result In the same 



\Jr 



7) If value of a parameter in one command is to be used as the 
name of a parameter in another command* then the same name 
will be used for the parameter value as well as the parameter 
name. For example consider the command 
M DEFINE_COMMAND_ENVIRONMENT" used to define the command 
environment for an operator. This command can have "ce" or 
"command. echo** as a name of one of the parameters. The 
command "DISPLAY_COMMAND_ENVIRONMENT" used to display the 
command environment has a parameter called "do" or 
"dlspl ay_optlons M . One valid value for this parameter can be 
used to display the value of the "command_echo n parameter as 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 

2.1 COMMAND NAME CONVENTIONS 



set In the "DEFINE j:OMMAND_ENVIRONMENT" command. The keyword 
name for this value should be "ce" or "command. echo"* I.e. 
same as the name of the corresponding parameter name. 



2 . 2 P^£A!iEIEE_y.ALU£_£QliY.EBIIQ!!S 



The values which may be specified for the command parameters will 
always be of a well known type. The following is a list of valid types. 

Integer 

Name 

String 

Bool ean 

keyword 

List type 

Record type 

Union type (Any) 

Appl ication type 

These value types are described next using the NOS/VE SCL metalanguage V .>' 
rules. These rules are described in section 5 of this document. Most 
of the material in this section has been extracted from the NOS/VE 
command writer's guide. 

The description of various types is preceded by a definition of 
various types of constants which are used in ' the definition of above 
types. 
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2,0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 
2.2.1 DEFINITION OF CONSTANTS 



2.2.1 DEFINITION OF CONSTANTS 
2.2.1.1 I£1I££ERS 



An Integer constant is a sequence of digits* the first of which must 
be a decimal digit* optionally prefixed by a sign and optionally 
suffixed by a radix enclosed in parentheses. The constant must be 
delimited at both ends. No spaces are permitted between the digits and 
the radix specification. 



<integer> six [<sign>3 <unsigned integer> 

<unsigned integer> ::= <dlgit> C<hex digit>3... t<(> <radix> <)>] 

<sign> ::» <+!-> £<sp>3 

<♦!-> ::= + ! - 

<hex digit> ::» <digit> !A!B5C!D!E!F 

Ja!b5c!d!e!f 

<radix> a* <unsigned decimal> 

<unsigned decimat> ::* <digit>... 



An integer constant can be expressed in any radix between two and 
sixteen. When the radix specification is omitted* ten (decimal) is 
assumed. Besides ten (decimal)* the most common radix values are 
sixteen (hexadecimal)* eight (octal) and two (binary). No distinction 
is made between lower and upper case hex digits by the CDCNET command 
parser. 



o 



When a radix greater than ten is specified* a leading zero digit may 
be required to ensure that the constant begins with a decimal digit. 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 
2.2.1,1 INTEGERS 






This Is to avoid ambiguity between* for example* the sixteenth element 
of the array whose name is Al given by Al(16)» and the hexadecimal 
representation of the decimal value 161 denoted by 0AK16). 

Spaces may not appear between the sign and unsigned integer in 
certain contexts* most notably in expressions for parameter values. See 
the syntax definition for numeric expressions for details. 

Example: 63* 77(8), -63( 10>* 3f(16)» 111111(2)* Oabc( 16 ) 



2.2.1.2 UAflE-CQtlSIAtil 



A name is a sequence of from 1 to 31 alphanumeric characters 
the first of which must not be a digit and which must be 
delimited at both ends. 

In a name the case of letters is irrelevant and 
all lower case letters appearing in a name are "folded" to 
their upper case counterparts. 



,/~- 



<name> :: = <alphabetic char> C< a I phanumer ic char>l... 
<alphanumer i c char> ::■ <alphabetlc char> J <digit> 



<a1phabetic char> ::» <letter> 

! <special alphabetic char> 

5 <i nternat i ona I alphabetic char> 



<letter> ::» A : B 
{ N ! 

: a : b 



J n ! o 



C ! D 

P { Q 

c J d 

P ! q 



E 

R 
e 
r 



F 
S 
f 

s 



G 

T 

g 

t 



H 5 I J J ! K 

U ! V ! W J X 

h ! i ! j ! k 

U S V ' W • X 



L 
Y 
I 

y 



M 

Z 
m 

z 



<special alphabet i c_char> ::» # ! $ J 3 ! _ 

international alphabetic char> ::» _C_ ! \ ! _3_ ! A 

• *•/■• ■ »\« 

» » V t _ t _ t J I 

<digit> ::»0!1!2!3J4!5J6!7J8}9 



Example: x* SdAtE, thi s_i s_a_semi_long_name 
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2.2,1.3 STRING CONSTANT 



2.2.1.3 siaias-causiAHi 



A string constant Is any (possibly empty) sequence of ASCII 
characters enclosed in apostrophes (single quote marks). 
The apostrophes are not part of the string but serve as 
delimiters. To include an apostrophe In the string* two 
consecutive apostrophes are used. The string must be 
delimited at both ends. 



<string> ::= ♦ Kstring char>]... » 

<strlng char> a* <any asci I character except •> ! '* 



Example: *This is a string. 1 

•Here is an enclosed apostrophe •» character. 1 

'* "a null (empty) string" 

»'»' **a string containing only an apostrophe" 







2. 2.1. A aQQL£AH.CQHaiAI!I 



A boolean constant is represented by one of the names shown below. 
These names are interpreted as boolean values only in those contexts 
which require boolean values. 

<boolean> s:« <true> I <false> 
<true> :s« TRUE ! YES } ON 
<false> :s« FALSE J NO 1 OFF 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 
2.2.2 DEFINITION OF TYPES 

2.2.2 DEFINITION OF TYPES 

2.2.2.1 I!iI£SEE_im 

<integer type> ::» INTEGER t<sp> <subrange>l 
<subrange> :s= <min integer> <••> <max integer> 
<min integer> :»» <integer expression> 
<max 1nteger> ss* <integer expression> 

The subrange specification can be used to restrict the range of 
values applicable for the type being defined. The value of <mln 
integer> must be less than or equal to that of <max 1nteger>. 



2.2.2.2 UASE-IIEE ^ 

f\ 

<name type> ss* NAME C<sp> <name s!ze>3 

<name size> a* Kmin name size> <••>] <max name size> 

<min name size> :s* <integer expression> 

<max name size> s:* <integer expression> 

The name size specification can be used to restrict the length of 
names applicable for the type being defined. The value of <m1n name 
size> must be less than or equal to that of <max name size> and both 
must be in the range 1..31. If <min name size> is omitted* 1 is 
assumed. If <max name size> is omitted* 31 is assumed. 



2.2.2.3 mmfi-IXEE 



<string type> ::■ STRING C<sp> <string size>] 

<string size> s:« <min string size> <••> (max string size> 

! <fixed string size> 



; ' '£sm c? : iV iv.i" ATi-'ttB-'x 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 
2.2.2.3 STRING TYPE 



<m|n string size> ::» <lnteger expression> 
<max string size> ::= <integer expression> 
<flxed string size> ::» <integer expression> 

The string size specification can be used to restrict the length of 
strings applicable for the type being defined. The value of <mln string 
size> must be less than or equal to that of <max string size> and both 
must be in the range 0..$max_str i ng. If the string must be of one 
particular length* the <fixed string slze> specification can be used to 
give values for both <min string size> and <max string size>. If the 
<string size> specification is omitted* is assumed for <mln string 
size> and $max_string for <max string size>. 



2.2.2.4 aflQL£A!l-II£E 
<boolean type> :s» BOOLEAN 

2.2.2.5 H£XHQ£a-II££ 

The keyword type is generally used for designating a set of options* 

<keyword type> ::» KEY <sp!nl> 

<keyword groups> 
KEYENO 

<keyword groups> ::* <keyword group> <*!sp!nl> 

[<keyword group> <• !sp!nl>] •• • 

<keyword group> ::« <(> <keyword> C<*!sp> <keyword>3... <)> 

S <keyword> 

<keyword> ::= <name> 
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2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 
2,2.2.6 LIST TYPE 

2.2.2.6 L1SL.IX£E 

Lists should be used for structuring data whose elements are* in 
general* to be accessed sequentially* or in cases where the actual 
number of elements in the list will vary from one usage to the another. 

< 1 1 st type> s:» LIST C< I 1st type qualifiers 

<l 1st type qual if ier> ::* 

C<sp> <list size qualifiers <sp> OF <sp> <type expression> 

<Hst size qualifier> a* <min list size> <..> <max list size> 

<min list size> *:» <integer expression> 

<max list size> s:» <integer expression> 

The list must have at least <min list size> elements. If <min list 
size> is not specified* zero is assumed. The list may not have more 
than <max list size> elements. If <max list size> is not specified* 
there is no limit to how many elements the list may have. 

The list type qualifier may be omitted when defining a type for a 
parameter of a command. The omission means that the parameter may be 
passed a list with any element type. 



2.2.2.7 £££Q£J2_II££ 

Records provide a structuring mechanism for grouping data items of 
different types together. Each item is called a field of the record and 
is referenced via its field name. 

<record type> ::» RECORD <sp!nl> 

<field definltion> <*Jsp!nl> 

C<f 1 e 1 d definltion> <* !sp !n I >!.. . 

RECEND 

<field definition> ::- 

<field name) [<sp!nl>] <:> C<sp!nl>3 <type expression> 



o 






o 
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2.2.2.8 UMIQU-IXEE 

The union type provides for the case where any one of a number of 
types is appl icabl e. 

<union type> a- ANY t<union type qualifier>3 

<union type qualifier> :*■ <sp> OF <sp?nl> 

<member definition> <»'sp!nl> 
C<member definition> <* ' sp ' nl>3«. • 

ANYEND 

<member definition> t:= <type> 

If the union type qualifier is omitted the union consists of all 
possible types. 



&: 



The order in which the members of the union type are defined is 
significant. If an expression for a union type can be successfully 
interpreted for more than one of its member types* it is given the first 
ch interpretation. 



Example: var 

x: any of 
name 
fi le 
anyend 
varend 



x - fred 

di spl ay_value StypeCx) 

NAME 

x « Swork.fred 

di spl ay_va lue $type(x) 

FILE 
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2.2.2.9 APPLICATION TYPE V, 

2.2.2.9 AE£UCAUOM.IXEE 

Application types may be defined to deal with those situations where 
no other type known by the CDCNET command parser can be used. 

Application type> *: = 

APPLICATION Ksp> Application value evaluator name>] 

The application value evaluator designates a procedure supplied by 
the application (product* utility* user program* etc.) to parse and 
evaluate an expression of the particular application type. This 
procedure assumes total responsibility for the evaluation of the 
"expression" for the application value. 



2.2.3 MAXIMUM SIZE OF PARAMETERS OF TYPE NAME 

c 

Even though the definition of type name allows one to have names w' 
whose maximum size may vary between 1 and 31 characters* all name type 
parameters (in CDCNET commands) which are externally visible to an end 
user or a CDCNET operator must support a maximum size of 31 characters. 
In other words the size of all externally visible name type parameters 
may range from 1 to 31 characters. 



2.3 £A£A!lEIER-tiA£iE_aEQE&I!a& 



The following rules are used to position values of parameters when a 
command is used. These rules are being provided here as things to be 
kept in mind when specifying a command and its parameters. Other than 
that this information has no purpose in this document. 

Parameters for a command are specified as a seauence of individual 
parameters separated by commas or spaces. Parameters may be specified 
positionally or by name. When a parameter is not specified by name its 
position is taken to be one beyond that of the preceeding parameter. 
The significance of explicitly omitting a parameter (e.g. by placing 
two commas together) is only to establish the position of the next 
parameter. Giving a parameter by name has the effect of "tabbing" to 
that parameter position. (1 N , 



!>'. 
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c 



2. * CJ2fiMN&-aES£aiEIIQM-CQUy.E!iIIQiiS 



This section describes the conventions to be used to describe a 
command in the internal documents like the functional and network ERSs. 
These conventions should not be used in the external documents like a 
reference manual or a user guide* These conventions have been 
established to facilitate extraction of most of the command description 
from the source code for the associated command processor* As a matter 
of fact* the conventions to describe the command parameters are 
identical to the rules for the specification of the parameter 
description table or POT. 

The following is a line by line description of these conventions. It 
is fol lowed by an example showing the use of these conventions. 

1) The first line of the description contains the command name* 
its alias if any* and Its abbreviated name* each separated by 
a comma (*) and a space* 

2) The first tine is followed by a brief English language 
description of the purpose of the command* 

3) The description of the command purpose is followed by a blank 
line. 

4) This blank line is followed by the parameter description table 
( PDT ). The following is the general format in which the PDT 
is described. The subsequent steps describe the specific 
conventions to describe the PDT. 

PDT var ai able_name_pdt( 

command parameter definition 
command parameter definition) 



5) The string "var ai ab le.name'' in the first line of the PDT is 
identical to the abbreviated name for the command being 
descr I bed. 

6) If the command does not contain any parameters* then the left 
parenthesis in the first line of the PDT specification is 
omitted. 

7) The first line of the PDT specification and specification of 
the definition of the first command parameter should be 
separated by one blank line. 
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8)The following is a specification of the command parameter 
definition in the NOS/VE SCL metalanguage. 

<command parameter definition> ::» 
<parameter names> 
CC<spJnl>] <:> [<sp!nl>] <type>3 

tt<sp'nl>3 » C<sp!nl>l <parameter default speci fi cati on>] 
s <empty> 

<parameter names) a- <parameter name) £<»isp> <parameter name>3... 

<parameter default speci fi cat ion> ::« SREQUIRED 

S $OPTIONAL 
! <value> 



The following is somewhat less abstract method to specify the command 
parameter definition within the POT definition. 



parameter names s type_spec if i cat ion « default specification 



9) The parameter names portion of the parameter definition 
contains the name of the parameter* its alias if any> and its 
abbreviated name; each separated by a comma (») or a space. 

10) The type_specif icat i on portion of the parameter specifies the 
type of the parameter to be one of the valid types for the 
CDCNET command parameters* as described in section 2.3.2. The 
following are some examples of type_spec i f i cat ions. 

boolean - specifies the parameter to be of type boolean. 

integer - specifies the parameter to be of type integer. 

integer 0..7 - specifies the parameter to be of type integer whose 
value can range from to 7. 

string - specifies the parameter to be of type string. 

string 3. .21 - specifies the parameter to be of type string whose 
size may range from 3 to 21 characters. 

string 3 - specifies the parameter to be of type string whose size 
is fixed and is equal to 3 characters. 

name - specifies the parameter to be of type name. 






2-16 



CONVENTIONS AND GUIDELINES FDR CDCNET COMMANDS 



c 



b 



2.0 CDCNET COMMAND CONVENTIONS AND GUIDELINES 
2.4 COMMAND DESCRIPTION CONVENTIONS 



name 1..5 - specifies the parameter to be of type name whose size 
may range from 1 to 5 characters. 

list of name - specifies the parameter to be a list of names ( 
with no upper limit on the number of names in the list) 

list 2..12 of name - specifies the parameter to be a list of names 
which may contain between 2 and 12 names. 

any of integer name - specifies the parameter to be either of type 
integer or name. 

list of any of name integer - specifies the parameter to be a list 
of either names or integers. 

11) The type_speci f icat ion portion of each command parameter 
definition should be intended so that this portion starts in 
the same column for ail parameters. 

12) The def aul t_speci f icati on portion of the parameter definition 
determines whether a parameter must be included as one of the 
command parameters* or can be omitted and if so what its 
default value is* if any. If no default specification is 
given* it is assumed to be SQPTIONAL. 

SREQUIRED specifies that the parameter must be supplied when 
the command is used. 

SOPTIONAL specifies that the parameter may be omitted when 
the command is used* and if omitted no default value is 
assigned to the parameter. 

If a value is given for the def aul t_speeci f i cat i on* the 
parameter may be omitted and if omitted* the specified value 
is assigned to the parameter. 

12)The description of the definition of one command parameter may 
be spread over several lines to make it more readable. This 
will be specially desirable if the parameter is of type key 
and several values for the key need to be included in the 
definition. If multiple lines are to be used to specify the 
definition of a single command parameter* then the second and 
subsequent lines should be intended so that they all start in 
the same column. This column should be one column position to 
the right of the column in which the last character of the 
type field resides. 

13)The character (s) which separates the parameter name and the 
type specification portions should be present in the same 



^'^^^■iJ»^ , ';:t.V'-ri'i''Iti">V'~^v"l^V'^ Z^lZi'-'jJi'"^-'.^^ ti; ViPT.-i' i-i-Ai^'Ti 
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column for all parameter definitions. 

14) The notation of two dots (..) to indicate line continuation 
should be used as necessary. 

15) The description of the POT should be followed by a brief 
English language description of each command parameter. 






~> 
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The following example will illustrate the use of above rules. 



DEFINE.LINE, DEFL 

This command is used to create the initial definition of a communication 
line. It describes the hardware address of the line and associates a 
logical name with it. It also specifies the values of various 
configurable operational parameters for the line. 



PDT defl_pdt( 

I ine.„interf ace_modu1e* I im 
port_number> pn 
tip_type* tp 



term I nal.conf i g.procedure 
* ine.type 
f raming_type 
carr i er_type 
I i ne_speed 

auto_recogni tion 
connect i on_connect_t J me out 
connect i on_di sconnect_ti me out 
user.connecti on_l t mi t 
transmissi on_b lock_s i ze 



* SREQUIRED 
- Srequlred 



asynct ip 



Integer 0..7 
integer 0..4 
key asynctip 

haspt ip 

sdfc3270 
name = SOPTIONAL 
key swi tched* dedi cated 

async»sync*sdlc»hdl c 

constant»controHed 

110* 150* 300*600* 1200,2400 

4800*9600*19200 » 300 

none»s* sc* scp * s 
integer 20. .1000 = 100 
integer 4. .1000 » 40 
integer 1..16 » 3 ^ 
integer 801 16) ..Of ff (16 ) = 80116) 



key 
key 
key 

key 



dedicated 
* async 
= control led 



The above definition will be followed by a brief description of 
individual parameters. 
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3.0 £Q£H£I-£iHU!AliQS 



The CDCNET commands can be grouped Into two major groups. The first 
group includes commands which are available to the end user accessing 
the CDCNET through a terminal device. The second group includes 
commands which are available to a CDCNET operator and the network 
analyst to manage the CDCNET. This section provides a very brief 
description of commands in these groups. Wherever appropriate* the 
command verbs and objects are also described separately. 



3 . 1 IEEBIML-USEE-CQtlM.A&lQS. 
3.1.1 OBJECTS 



The following is a list and brief description of the objects used in 
the terminal user commands. 

IIEE QESCEIEIIQU 

CONNECTION(S) Used to specify an association between a 

user and an application to which the user 
is connected to or wants to connect to. 

WORKING.CONNECTION Used to indicate the primary or currently 

in use connection if more than one 
connections exist at a given time. 

CONNECTION_ATTRIBUTES Used to indicate attributes of a 

connecti on. 

TERMINAL_ATTRIBUTES Used to indicate the attributes of a 

term i na I • 

STRING Used to specify a data string which may be 

obtained from the terminal user. 

LINE Used to specify a data line which may be 

sent to the terminal user. 



V. 
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3.1.2 VERBS 



The following is a list and brief description of the verbs used In 
the terminal user commands. 

II££ QESCSIEIIQU 

CREATE This verb is used to create a connection. 

DELETE This verb is used to delete a connection. 

CHANGE This verb is used to change one or more configurable 

operational parameters of a connetion or a terminal. 
It is also used to select a connection as the working 
or primary connection. 

DISPLAY This verb is used to display the list of connections* 

attributes of a connection and attributes of a 
termi na I • 

ET This verb is used to obtain a string from the 

terminal user. 

PUT This verb is used to send a data line to the terminal 

user. 

DO This verb is used to initiate processing of a 

terminal user procedure. 

HELP This verb is used to establish a connection with a 

help service. 



3.1.3 COMMANDS 

The following is a list and brief description of the terminal user 
commands. 

ham aESdEiEiiaa 

CREATE_CONNECTION Used to create a new connection. 

DISPLAY.CONNECTIONS Used to display the current list of 



I 
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connections. 

CHANGE.WORKING.CONNECTION Used to select one of the connections as 

the working connection. 

DELETE.CONNECTION Used to delete a connection. 

DISPLAY_C0NNECTI0N_ATTRI3UTES Used to display the attributes of a 

connect i on. 

DISPLAY_C0NNECTI0N_ATTRI8UTE Used to display a single attribute of a 

connection. 

CHANGE_C0NNECTI0N_ ATTRIBUTES Used to change the attributes of a 

connection. 

DISPLAY.TERMINAL.ATTRIBUTES Used to display the attributes of the user 

terminal • 

CHANGE_TERMINAL_ATTRI8UTES Used to change the attributes of the user 

terminal • 

GET_STRING Used to obtain a string from a user»s /"""^ 

terminal as input. V..y 

PUT_LINE Used to send a line to the terminal user. 

HELP Used to establish a connection with a 

service which provides help to a terminal 
user. 

DO Used to initiate processing of a terminal 

user procedure. 



3 . 2 £QC8EI_flAHAfiE&EBI-£Qli&A&aS 



This section describes the various commands used to manage the CDCNET 
network. These commands have been further divided into sub-groups. 
Commands in each sub-group are described In separate sub-sections. 



"> 
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3.2.1 COMMANDS TO MANAGE EXTERNAL RESOURCES 



Communication lines* ethernet and C170 channels connected to a DI are 
viewed as its external resources* The commands in this group are 
concerned with the definition and control of these resources as well as 
the software directly responsible to interface with them. The commands 
in this group and their verbs and objects are described next. 



3.2.1.1 Qfll££IS 



The following is a list and brief description of the object names 
used In the terminal user commands. 



II££ QESCEIEIiaii 







TRUNK A trunk Is a logical entity. It consists 

of a physical medium (e.g. ethernet. 
communication line) and the link layer 
software used to interconnect two or more 
CDCNET systems. 






NET A net or network is a logical entity. It 

consists of a trunk or an X.25 virtual 
circuit and the definition (e.g. cost* 
network identification) which lets It to 
be used as a network solution. 

LINE A line Is used to connect a terminal or a 

unit record device to a CDCNET system. It 
consists of a communication line and the 
Terminal Interface Process software needed 
to transfer data on It. 

TERMINAL This object Is used to identify a user 

terminal • 

A trunk or a net can be qualified by its type. The following are the 
valid qualifiers for these objects. 

. HDLC 

. CHANNEL 

. ETHER 



^jj'jj.-u-j .'.■„*■' vi:' 1 .:J' ■w i j : ^i/-'^**^ i £ri'-'-- r «~-' ■ iiii r -.r.: 4 . ■''-:'; :, '.£i'''.L; ; '-.i'';:t*:; i. 'J'CT- :'_'■'■" '.'.t's '■•?=-*' n.'j^*-* j rV. ! » 
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. X25 



3.2.1.2 it££&I 



The following is a list and brief description of the verbs used in 
the terminal user commands. 

IXEE QESCfclEIiatl 

DEFINE This verb is used to create the Initial definition of 

a line* trunk* a network solution or a Terminal 
Interface Process software (TIP). 

CHANGE This verb is used to change one or more configurable 

operational parameters of a line* trunk* a network 
solution or a TIP. 

CANCEL This verb is used to remove or cancel the definition ^~\ 

of a line* trunk or a network solution. v 

START This verb is used to initialize the hardware and 

software needed to make a line* trunk or a network 
solution operational. The term operational as used 
here implies the state in which an element (e.g. 
line) can be used for data transfer. 

STOP This verb is used to change the state of a line* 

trunk or a network solution so that it is no longer 
operat I onal • 



rf~\ 
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3.2.1.3 _Q__AUQS 

3.2.1.3.1 QfcEimiQtt-A&O-CtiAttaE.SLQflfiAUQS 

These commands have the following generic format: 

DEFINE.XXXX 
CHANGE_XXXX 



Where the string XXXX represents the object to be defined or changed 
The following is a list of all definition and change commands. 




DEFINE_HDLC_TRUNK 
DEFINE_ETHER_TRUNK 
OEFINE.CHANNEL.TRUNK 
DEFINE_X25_TRUNK 
DEFINE_HDLC.NET 
EFINE_ETHER_NET 
EFINE_CHANNEL.NET 
DEFINE_X25 NET 
DEFINE.LINE 
DEFINE_TERMINAL 
DEFINE_TIP 



CHANGE_HDLC_TRUNK 

CHANGE_ETHER_TRUNK 

CHANGE.CHANNEL.TRUNK 

CHANGE_X25_TRUNK 

CHANGE_HDLC_NET 

CHANGE_ETHER_NET 

CHANGE_CHANNEl_NET 

CHANGE_X25.NET 

CHANGE.LINE 

CHANGE.TERMINAL 

CHANGE.TIP 



The f o I I owing 

commands. 



is a brief description of the define and change 



o 



The define commands are used to create the initial definition of the 
element being defined. This initial definition includes the 
identification of the hardware resources needed to support the element 
being defined* values of all configurable operational parameters which 
are required as well as the values of optional configurable operational 
parameters* for whom non default values are to be used. This definition 
also associates a logical name with the element being defined. All 
references to this element in the subsequent commands are made via this 
logical name. 

These commands are processed by acquiring ownership of the hardware 

resource (if any} needed to support the element being defined and 

creating the data structure(s) needed to store its operational 

parameters. 

The change commands are used to change values of one or more 
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configurable operational parameters of the specified element. These 
commands require that the element whose operational parameters are to be 
changed must have been defined previously via the define command. This 
requirement is enforced by requiring the command parameters to specify 
the logical name of the element defined in the corresponding define 
command. 

It should be noted that a change command can be used as often as 
necessary. Also the change command changes the values of only those 
parameters which are explicitly identified In the change command. 

3.2.1.3.2 maii.-SIQE-AliQ-CAliCEL-CriflfiAHDS 

This group includes the following commands. 

START TRUNK STOP.TRUNK CANCEL.TRUNK 

START NET ST0P.NET CANCEL.NET 

START.LINE ST0PJ.INE CANCEL.LINE 
CANCEL_TERMINAL 



The following is a brief description of the start* stop and cancel 
commands. 

The start commands are used to make the specified element 
operational. The term operational Is used here to Imply the situation 
or state when the element Is available for data transfer. The start 
commands have only one parameter. This parameter identifies the element 
to be started by its logical name. The processing of start commands 
usually involves initialization and start up of the software and 
hardware responsible to support data transfer on the element being 
started. 

The stop commands are used to change the state of an element so that 
It is no longer capable of supporting data transfer. The stop commands 
have only one parameter. This parameter Identifies the element to be 
stopped by its logical name. The processing of stop commands usually 
involves termination of the software responsible to support data 
transfer on the element being stopped. 

The cancel commands are used to delete the definition of the 
specified element. These commands* among other things* delete the data 
structures created for the element by the corresponding define command. 
The cancel commands have only one parameter. This parameter identifies 
the element* whose definition is to be deleted by* its logical name. 



if 



~x 
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3.2.2 COMMANDS TO MANAGE SOFTWARE RESOURCES 



This section describes the commands used to manage software resources 
in a CDCNET system. Software resources include individual software 
elements or groups of software elements which together provide a 
specific service or a function. 

The commands in this group are concerned with loading and unloading* 
start up and termination of software components as well making changes 
in their configurable operational parameters. 



3.2.2.1 CS1ECIS 




The object names in the commands used to manage the CDCNET software 
are either the names of individual software elements or functions (e.g. 
X.25_INTERFACE) provided by a group of software elements.. The following 
s a list of the object names used in the commands used to manage the 
Software resources. 

C170.INTERFACE 

C170.BATCH.GW 

C170_IVT_GW 

X25.INTERFACE 

X25_GW 

DIRECTORY 

OSA 

DEVICE_MANAGER 

XNSSP.TRANSPORT 

CDNA_TRANSPORT 



3.2.2.2 VERBS 



The following is a list and brief description of verbs used In the 
commands used to manage the software resources. 



IIEE 
LOAD 



t> 



D.ESCRIEIIQN 

Used to load an 
CDCNET system. 



individual software module in a 
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START Used to set configurable options and start up either 

an Individual software component or a group of 

software components which together provide a service 
or a function. 

STOP Used to stop execution of either an individual 

software component or a group of software components 
which together provide a service or a function. 

CHANGE Used to change configurable options of an individual 

software component or a group of software components 
which are already executing. 

UNLOAD Used to release the memory being used to store an 

individual software component which is not executing. 

RETAIN Used to identify software components which should not 

be automatically unloaded to free up memory. 



3.2.2.3 aaniiMQs fO- 

~*. /' 

3.2.2.3.1 SQEIHASE J.QAQt.-amitt- AU£-UULQAU JII^Mm 

There is a single load command called "L DA D_ MODULE" • This command 
has a single parameter which is used to identify the software module to 
be loaded. This command is usd to load a software module in a CDCNET 
system. 

There is a single retain command called "RETAIN_MODULE H . This 
command has a single parameter which is used to identify the software 
module which is to be retained* This command is used to prevent 
automatic unloading of an inactive software module to free up memory. 

There is a single unload command called "UNLOAD_MODULE". This 
command has a single parameter which is used to identify the software 
module to be unloaded. This command checks if the module to be unloaded 
is in use. If it is not being used, the memory used to store it is 
freed up. 

3.2.2.3.2 Sfl£IJlA£E-SIAai-U£A£ttAI!£E^IlQ-iia£-£QllIlA!lQi 

The software start up» change and stop commands have the following 
generic names. 



START_XXXXX 



y 
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AND STOP COMMANDS 



. CHANGE.XXXXX 
. STOP.XXXXX 

Where the string XXXX identifies an individual software element or a 
service or function which is provided by a group of software elements. 



START.C170_INTEPFACE 

START.C170_3ATCH.GW 

START_C170_IVT_GW 

START_X25_INTERFACE 

START.X25.GW 

START.OSA 



The f oi lowing 
commands. 



CHANGE.C170.INTERFACE 
CHANG£_C170_BATCH_GW 
CHANGE_C170_IVT_GW 
CHANGE_X2 5_INTERFACE 
CHANGE. X25_GW 
CHANGE. OSA 
CHANGE.DIRECTORY 
CHANGE.XNS.TR AN SPORT 
CHANGE.CDNA.TRANSPORT 



ST0P.C170.INTERFACE 

ST0P.C170.BATCH.GW 

ST0P.C170_IVT.GW 

ST0P.X25.INTFRFACE 

ST0P.X25.GW 



is a brief description of the start* change and stop 




The start command is used to start up one or more software elements. 
The parameters on this command are used to provide the values of 
required operational parameters as well as the optional operational 
arameters for which non-default values are to be used. If the software 
element or elements which are to be started are not present in the 
system* these are loaded in the CDCNET system and then started. There 
are certain software elements in a CDCNET system which are required for 
the system to do any useful work (e.g. accept and process a command). 
These software elements get started automatically when the system is 
loaded* and therefore no start commands are needed or defined for these 
elements. 



The change command is used to change the values of one or more 
configurable operational parameters of a single software element or a 
group of software elements which are already executing. The parameters 
on this command are used to provide the values of operational parameters 
which are to be changed. 

The stop command is used to stop execution of an individual software 
element or a group of software elements which are together providing a 
service. or a function. 



3.2.3 COMMANDS TO MANAGE LOGICAL ELEMENTS 



t) 



Certain elements in a CDCNET system can not be designated as software 
or hardware resources or external resources. Some examples of these 
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elements are the groups of log messages which may be emitted by a given 
system* or a definition of communities In the network. This section 
describes the commands which deal with such elements. 



3.2.3.1 Q&iECIS 



The following is a list and brief description of objects used in the 
commands used to manage the logical elements in a CDCNET system. 

HAflE HESCRimQU 

COMMUNITY_SEGMENT Used to refer to a sub-set of a community* 

which includes a set of CDCNET systems 
which are connected to the same network 
solution and also are members of the same 
community. 

COMMUNITY_MEMBERSHIP Used in a command which defines a CDCNET 

system to be a member of a specified I 
community. ( *-- 

LOG.COMMUNITY Used to associate a community of CDCNET 

systems with the Independent LOG M-E which 
is responsible to process certain log 
messages from systems in this community. 

CIM_INTERFACE Used to refer to the interface between the 

DVM and CIM firmware. 

ESCI_INTERFACE Used to refer to the interface between the 

DVM and ESCI firmware. 

SYSTEM Used to refer to the CDCNET system as a 

whol e. 

FILE_TYPE Used to identify the type of files* access 

to whom is supported by the Independent 
File Access M-E. 

LOG.MESSAGE Used to refer to a log message which may 

be emitted from a CDCNET system. 

ALARM.MESSAGE Used to refer to an operator alarm which 

may be emitted from a CDCNET system* 
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AIAPM.ENVIRONMENT 



LOG.ENVIRONMENT Used to refer to the list of log messages 

(and the associated list of log 
communities) whose emission was enabled 
during the system configuration* i.e. the 
list which does not include the changes 
made by any online commands after the 
system configuration has been completed. 

Used to refer to the list of alarm 
messages whose emission was enabled during 
the system configuration* i.e. the list 
which does not include the changes made by 
any online commands after the system 
configuration has been completed. 

the command used to indicate the 

completion of the initial or configured 

definition of list of log messages which 

may be emitted from a given CDCNET system. 

ALARMING;Used as the object in the command used to indicate the 

completion of the initial . or configured 
definition of list of alarm messages which 
may be emitted from a given CDCNET system. 



LOGGING:Used as the object in 



LOGGING.THRESHOLD 



Used to refer to the count of an event 
which is used as a threshold to decide if 
a log message should be generated to 
report that event. 



B00T_0EFAULTS 



EXCEPTION.SYSTEMS 



Used to refer to the defaults (e.g. 
version of the object library) used to 
load a CDCNET system. 



used to 
should be 
1 1 brary. 



Identify CDCNET systems which 
loaded from a non-default object 



3.2.3.2 ii£ESS 



The following is a list and brief description of the verbs used in 
the commands used to manage the logical elements in a CDCNET system. 



IXEE 



QE&C&IEIIQli 
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DEFINE This verb Is used to create initial definition of a 

logical element. 

CHANGE This verb is used to change the definition of a 

logical element. 

CANCEL This verb is used to delete the definition of a 

logical element. 

ADD This verb is used to enable the emission of a log or 

alarm message. It is also used to add a file type to 
be supported by the Independent File Access M-E. 

DELETE This verb is used to disable the emission of a log or 

alarm message. It is also used to delete a file type 
to be supported by the Independent Fi le Access M-E. 

RESTORE This verb is used to replace the current list of log 

and alarm messages whose emission is enabled with the 
corrsponding list defined as a part of the system 
conf igurati on. 

START This verb is used to indicate completion of the 

Initial or configured definition of log and alarm 
messages which may be emiited from a given CDCNET 
system. 

RESET This verb is used to force a CDCNET system to reset 

itself. 



3.2.3.3 CQMMAUUS 



The following is a list of commands which deal with the logical 
elements in a CDCNET system. 

DEFINE_COMMUNITY_SEGMENT 

CANCEL.COMMUNITY.SEGMENT 

DEFINE_LOG_C0MMUNITY 

CANCEL.LOG.COMMUNITY 

DEFINE.COMMUNITY.MEMBERSHIP 

CANCEL_COMMUNITY_MEMBERSHIP 

DEFINE.SYSTEM 

CHANGE_SYSTEM 

RESET.SYSTEM 4 ~ 

DEFINE_CIM_INTERFACE fl 
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DEFINE_ESCI_ 
CHANGE.LOGGI 
CHANGE_EXCEP 
CHANGE_BOOT. 
ADD_FILE_TYP 
DELETE_FILE_ 
ADD.LOG.MESS 
DELETF_LOG_M 
ADD_ALARM ME 
DFLETE.ALARM 
START_LOGGIN 
START.ALARMI 
RESTORE_LOG_ 
RESTORE_ALAR 



INTERFACE 

NG.THRESHOLD 

TION.SYSTEMS 

LOAD DEFAULTS 

E 

TYPE 

AGE 

ESSAGE 

SSAGE 

.MESSAGE 

G 

NG 

ENVIRONMENT 

M.ENVIRONMENT 



3.2.4 DISPLAY COMMANDS 




The display commands are used to display various attributes of 

ifferent elements of a CDCNET system. Some examples of the types of 

attributes which may be displayed are conflgurtion options* status* 

metrics (statistics)* list of log messages whose emission is enabled* 
etc. 

AM disply commands have a parameter called the "displ ay.options". 
The 'value of this parameter can be used to provide a list of things ( 
e.g. a specific configuration option) which are to be displayed. 



3.2.4.1 caiEm 



The following is a list and brief description of objects used in the 
display commands. 



NA.HE 

STATUS 

METRICS 

OPTIONS 



o 



Status of a CDCNET element 

Statistics collected for an element or 
data traffic In a COCNET system. 

Configuration options of an element in a 
CDCNET system. 



3-15 



CONVENTIONS AND GUIDELINES FOR CDCNET COMMANDS 



3.0 CDCNET COMMANDS 
3.2.4.1 OBJECTS 



o 



LOG.ENVIRONMENT 



ALARM.ENVIRONMENT 



COMMAND.ENVIRONMENT 



LOGGING.THRESHOLD 



0PERAT0R.LOG 



ALARM.HISTORY 



BOOT.DEFAULTS 



EXCEPTION.SYSTEMS 



PATHS 



Used to refer to the list of log messages 
which may be emitted from a CDCNET system 
and the list of systems where they get 
logged* 

Used to refer to the list of operator 
alarms which may be emitted from a CDCNET 
system. 

Used to refer to the command interface 
environment for a given CDCNET operator. 

Used to refer to the count of an event 
which is used as a threshold to decide if 
a log message should be generated to 
report that event. 

Used to refer to the operator log which is 
used to leave messages for CDCNET 
operators. 

Used to refer to the list of operator 
alarms which are retained for subsequent 
viewing by the CDCNET operator. 

Used to refer to the defaults (e.g. 
version of the object library) used to 
load a CDCNET system. 

used to identify CDCNET systems which 
should be loaded from a non-default object 
I ibrary. 

Used to refer to one or more paths between 
two CDCNET systems. 






The STATUS* METRICS and OPTIONS objects can be further qualified by 
one of the following. 

. Line. Trunk or a Network (network solution). 

• Type of a trunk le.g. HDLC_TRUNK) or a network solution (e.g. 

ETHER.NET). 
. System 
. Name of a software element (e.g. Directory) 

The list of Display commands should be used to determine which of 
these qualifiers can be used with which object. 



1 
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3.2.4.2 _££__ 



The display commands have only one verb called •♦DISPLAY*. 



3.2.4.3 _Q__AMQS. 



The following is a list of the DISPLAY commands. 

DISPLAY_LINE_STATUS 

DISPLAY_TRUNK_STATUS 

DISPLAY_NETWORK_STATUS 

DISPLAY.TRANSPORT STATUS 

DISPLAY_DIRECTORY_STATUS 

DISPLAY.SYSTEM.STATUS 

DISPLAY_HARDWARE_STATUS 

0^piSPLAY_LINE_METRICS 
DISPLAY_TRUNK_METRICS 
DISPLAY_NETWORK_METRICS 
DISPLAY_TRANSPORT_METRICS 
DISPLAY_DIRECTORY_METRICS 
DISPLAY_SYSTEM_METPICS 
DISPLAY_FAILURE_METRlCS 

DISPLAY_C170_INTERFACE_0PTI0NS 

DISPLAY_C170_3ATCH.GW.0PT IONS 

DISPLAY_C170_IVT_GW_0PTI0NS 

DISPLAY_X25_INTEPFACE_0PTI0NS 

DISPLAY_X25_GW_0PTI0NS 

DISPLAY_DIRECTORY_OPTIONS 

DISPLAY_OSA_OPTIONS 

DISPLAY_XNS_TRANSPORT_OPTIONS 

DISPLAY_CDNA_TRANSPORT_OPTIONS 

DISPLAY.PATHS 

DISPLAY.LOG.ENVIRONMEMT 

DISPLAY.ALARM.ENVIRONMENT 

DISPLAY.COMMAND.ENVIRONMENT 

DISPLAY_OPERATOR_LOG 

DISPLAY. ALAR M_HISTORY 

DISPLAY_LOGGING_THRESHOLD 

DISPLAY_LOGGING_THRESHOLDS 



o 
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3.2.5 OPERATOR INTERFACE COMMANDS 



This section describes the commands available to a CDCNET operator to 
manage his or her environment as well as to send commands to one or more 
CDCNET systems. 



,..-' 



3.2.5.1 Qflifim 



The following is a list and brief description of objects used in the 
operator interface commands. 

tlAJl£ 0£i££I£IIflM 

COMMAND Used as the object used in the command to 

send a command to one or more CDCNET 
systems* j-~ v 

& 

RESPONSE Used as the object in the command used to ^ 

route responses for one or more commands 
to a file or another device. 

COMMAND.ENVIRONMENT Used as the object in the command used to 

define or change the operator interface 
envi ronment. 

OPERAT0R.NOTE Used as the object in the command used to 

add a note in the operator log. 



3.2.5.2 y.£B.as 

The following is a list and brief description of verbs used in the 
operator interface commands. 

m&l QEsaaiEiiaa 

SEND Used to send a command to one or more systems. 

BROADCAST used to broadcast a command to all systems in one or (f ; 



c 
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more communities. 

DEFINE Used to define or set up the operator interface 

envi r onment. 

CHANGE Used to change one or more attributes of the operator 

interface environment. 

DO Used to invoke execution of commands from a command 

file. 

ADD Used to add a note in the operator log. 

ROUTE Used to route command rsponses to a file or a device 

(e.g. printer). 

QUIT Used to leave (i.e. exit from) the operator 

interface application. 



_3.2.5.3 LQflttAtLQS 





The following is a list of the operator interface commands. 
SEND.COMMAND 
BROADCAST_C0MMAN0 
DEFINE_COMMANO_ENVIR ONMENT 
CHANGE.COMMAND.ENVIRONMENT 
DO 

ADD.OPERATOR.NOTE 
ROUTE.RESPONSE 
QUIT 



c 
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3.2.6 FAILURE MANAGEMENT COMMANDS 



This section describes the commands used to manage failures In a 
CDCNET system as well as to test various hardware and logical elements. 



3.2.6.1 ruutcis 



The following Is a list and brief description of objects used In the 
failure management commands. 

UAtl£ QESCmilOI! 

ELEMENT_STATE Used in the commands used to change the 

state of a hardware element (e#g* a Mm or 
a port). 

TRAFFIC Used In the command used to change the f 

traffic rate on a trunk. V 

TEST Used in the commands to start or stop a 

test. 

PATH Used in the command to test a path between 

two CDCNET systems. 

The object "TEST" can be qualified with the element to be tested. 
Some examples of these qualifiers are MPB> SMM> PORT* etc. The command 
list in the following section shows all valid qualifiers* 



3.2.6.2 mas 

The following is a list and brief description of verbs used in the 
operator interface commands. 

tiitiE QESCEIEIIQti 

START Used to start a test. 

STOP Used to stop a test. 



c 
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CHANGE 



Used to change the state of a hardware element or 
rate of traffic on a given trunk. 



3.2.6.3 CQflUAIiQS 



The following is a list of the commands used to manage failures in a 
CDCNET system. 




CHANGE_ELEMENT_STATE 
CHANGEJTRAFFIC 
START_LOCAt.tOOPBACK_TEST 
START_REMOTE_LOOPBACK_TEST 

TART_PATH_TEST 
START_MPB_TEST 
START_CIM_TEST 
START_ESCI_TEST 
START_LIM_TEST 
START_PORT_TEST 
START_SMM_TEST 
START.CHANNEL.TEST 



QESCSIEIIQti 



ST0P_L0CAL_L00PBACK_TEST 

ST0P_REM0TE_L00PBACK_TEST 

STOP.PATH.TEST 

STOP.MPB.TEST 

STOP_CIM_TEST 

STOP_ESCI_TEST 

STOP_LIM_TEST 

STOP_PORT_TEST 

STOP_SMM_TEST 

STOP_CHANNEL_TEST 



3.2.7 MISCELLANEOUS COMMANDS 



The following are some miscellaneous commands which do not fall 
any of the command groups described earlier. 



NAtt£ 



o 



Q£S££IEIIQM 
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START.XXX.METRICS.COLLECTION 



STOP.XXX.METR I CS.COL LECTION 



START_XXX_METRICS_REPQRTING 



Used to start collection of statistics 
for a specified element. The string 
XXX ientifies the entity for which 
metrics collection is to be started. 

Used to stop cotection of statistics 
for a specified element. The string 
XXX ientifies the entity for which 
metrics collection is to be stopped. 

Used to start periodic reporting of 
statistics for a specified element. 
The string XXX ientifies the entity 
for which metrics reporting is to be 
started. 



STOP_METRICS_RE PORTING 



START.AUTO.RECOGNITION 



Used to stop periodic reporting of 
statistics for a specified element. 
The string XXX ientifies the entity 
for which metrics reporting is to be 
stopped. 

Used to start automatic recognition of 
certain (e.g. tine speed) attributes 
of a communication line. 



( 



J 
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4 . Ca^il££S-IH-£XISIIilfi-aQMJlAtlQS-Qi2E-IQ_££QEflSEG-CQtiSt£tJIIQtli 



This section describes the changes needed In the current definition 
of the CDCNET commands so that they follow the proposed conventions and 
guidelines. These changes are described separately for the command 
verbs* objects and the command names. 

This section is included In this document to provide some indication 
of the changes required in the current definition of the CDCNET commands 
because of the proposed conventions and guidelines. This section may be 
ignored as far as the review of the proposed conventions and guidelines 
is concerned. 



04.1 



CHAHfiES-lH-CQflflAMLJlERfiS 






This section describes the reasons for changes in the current command 
verbs. It also includes a list of current and proposed verbs along with 
a description of the proposed verbs. The following is a list of reasons 
for the proposed changes. 

1) The "DISABLE" and «DISPLAY« verbs have the same first three 
characters. Because of this the abbreviations for the 
commands which use these verbs* will be very similar. For 
example the abbreviations for commands "DISPLAY.LINE.STATUS" 
and "DISABLE"_LINE" will be "DISLS" and "DISL" respectively. 
In view of this the following changes are being proposed. 

The "DISABLE" verb should be replaced with the "STOP" verb. 
Then the command "DISABLE.LINE" will become "ST0P_LINE". Most 
of the functions provided by the "ENABLE/DISABLE" verbs will 
be provided by the "START/STOP" verbs. 

2) The "ACTIVATE/DEACTIVATE" verbs should be replaced with the 
"START/STOP" verbs* because these verbs are used to provide 
simi I ar functi ons. 
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3) The verbs "INHIBIT" AND "TERMINATE" should be replaced with 
the "STOP" verb* because all of these provide similar 
f uncti ons. 

4) The verbs "CHECK"* "ECHO">"LOOP3ACK" and "EXECUTE" should be 
replaced with the verb "START". An object name (e.g. 
"PATH_TEST") should be used to specify the type of testing to 
be done. 

5) The "CONFIGURE" verb should be replaced with the "DEFINE" verb 
so that the same verb is used to set or define all 
configuration parameters. 

b) The "ENTER" verb should be replaced with the "ADD" because the 
verb "ADD" can be used equally well to describe the function 
being performed by the "ENTER" verb. 

The following list uses the term "OLD NAME" for the current verb and 
the term "NEW NAME" for the proposed verb. Also included In this list 
is a brief description of the proposed verb. 

OLD NAME ADD* ENABLE* ENTER 

NEW NAME ADD 

DESCRIPTION Used to add a file type to the list of files 

supported by the Independent File access M-E. This 
verb is also used to add a log/alarm message to the 
list of log/alarm messages to be transmitted by a 
given system* as well as to add a message in the 
operator fog. 

OLD NAME BROADCAST 

NEW NAME Same 

DESCRIPTION Used to broadcast a command to one or more 

destination communities. 

OLD NAME CHANGE 

NEW NAME Same 

DESCRIPTION Used to change the hardware and software 

configuration parameters* to change state of a 
hardware element and to change traffic on a trunk. 

OLD NAME CREATE 

NEW NAME Same 

DESCRIPTION Used to create a connection. 

OLD NAME DELETE 

NEW NAME CANCEL 

DESCRIPTION Used to delete the definition of various elements A \ 



K.y' 
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OLD NAME 
NEW NAME 
DESCRIPTION 



OLD NAME 
NEW NAME 
DESCRIPTION 



\-/n 



LD NAME 
iNEW NAME 
DESCRIPTION 



OLD NAME 
NEW NAME 
DESCRIPTION 

OLD NAME 
NEW NAME 
DESCRIPTION 

OLD NAME 
NEW NAME 
DESCRIPTION 

OLD NAME 
NEW NAME 
DESCRIPTION 

OLD NAME 
NEW NAME 
DESCRIPTION 



to' 



OLD NAME 



like a terminal device* a communication line* a 
trunk* a network solution* etc. It is also used to 
delete a log/alarm message from the list of log/alarm 
messages to be transmitted by a given system. 

DELOAO 

UNLOAD 

Used to delete the information about the presence of 

a software module in the system and to free up the 

memory being used by that module. 

DISPLAY 
Same 

Used to display configuration parameters* status and 
statistics for various hardware and software 
elements; to display the list of connections and 
their attributes? to display alarm history and the 
operator log for a given operator* to disply the 
operators command environment as well as to display 
the list of log messages and alarms whose 
transmission is enabled. 

DO 

Same 

Used to cause a terminal user or operator procedure 

to be processed. 

FLUSH 

STOP 

Used to flush current statistics buffers. 

GET 

Same 

Used to input a string from a terminal. 

HELP 
Same 
Used to invoke Help utility. 

LOAD 
Same 
Used to load a software module in a CDCNET system. 

PUT 

Same 

Used to to output a string to the terminal user or to 

a service connected to the terminal user. 

QUIT 
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NEW NAME Same 

DESCRIPTION Used to quit or exit from the operator interface 

uti lity. 

OLD NAME RETAIN 

NEW NAME Same 

DESCRIPTION Used to mark a software module to be unloadabfe via 

the DELOAD command. 

OLD NAME ROUTE 

NEW NAME Same 

DESCRIPTION Used to route a command response to a file. 

OLD NAME SEND 

NEW NAME Same 

DESCRIPTION Used to send a command to a list of specified 

systems. 

OLD NAME SET* CONFIGURE 

NEW NAME DEFINE 

DESCRIPTION Used to set configuration parameters of software and 

hardware elements including communication tines; 
CDCNET system and terminal devices; to set various f> 
aspects of operator interface? to set connection 
attributes and to select the working connection. 

OLD NAME ACTIVATE* ENABLE 

NEW NAME START 

DESCRIPTION Used to start auto recognition on a communication 

line as welt as to start execution of a software 

component. Also used to start service on a 

communication line* trunk or a network solution; and 

to start statistics collection or reporting. 

OLD NAME DEACTIVATE. DISABLE, INHIBIT, TERMINATE 

NEW NAME STOP 

DESCRIPTION Used to stop execution of a software component. Also 

used to stop service on a communication line, trunk 
or a network solution; and to stop statistics 
collection or reporting. 

OLD NAME CHECK, ECHO, LOOPBACK, EXECUTE 

NEW NAME START 

DESCRIPTION Used to start execution of a diagnostics test. Also 

used to test a path or paths between two CDCNET 

systems. 



( 
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in 



4.2 £UAtifiES-Iti-IHE.£af!ttA>ia-Qa.iECL.MttES 



This section provides a list of current object names and proposed 
changes to some of them. The following are some of the reasons for the 
proposed changes. 

• Some of the current object names are too long and result in the 
command name size to exceed the 30 character limit. 

• In some cases different names are used for the same object. One 
example of this is the use of words "DI" and "SYSTEM". There is 
no reason to have both of these as valid object names. 

• The names "LINK" and "LINE" result in identical abbreviations for 
several commandsle.g OISPLAY.LINE. STATUS and DISPLAY.LINK.STATUS). 
In view of this the name "LINK" has been changed to "TRUNK". Also 
in order to maintain consistency names like "HDLC.LINK" and 
"MCIJ.INK" have been changed to "HDLC.TRUNK" and "MCI.TRUNK". 

The following is a list of current and proposed object names. 
Related object names have been grouped together. 



4.2.1 OBJECT NAMES FOR NETWORK SOLUTIONS, TRUNKS* LINES AND TERMINALS 



OLD NAME X25.NETW0RK.SOLUTION.ATTRIBUTES 

NEW NAME X25.NET 

DESCRIPTION X25.NET is used as the object in the command used to 

define and change the configuration parameters! e.g 
cost* remote DTE address) for an X.25 virtual circuit 
to be used as a network solution. 

OLD NAME NETWORK.SOLUTION.ATTRIBUTES 

NEW NAME HDLC.NET, MCI.NET, ESCI.NET 

DESCRIPTION These objects are used in the commands used to define 

and change the configuration parameters for network 
solutions using an HDLC line, channel interface and 
ethernet, respectively* as the communication media. 

OLD NAME NETWORK.SOLUTION 

NEW NAME NETWORK 

DESCRIPTION NETWORK is used as the object in the commands used to 

display status, statistics and configuration 
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attributes of a network solution. A command 
parameter is used to specify one or more network 
solutions whose status* statistics or configuration 
attributes are to be displayed. 

OLD NAME HDLC.LINK.ATTRIBUTES 

NEW NAME HDLC. TRUNK 

DESCRIPTION HDLC.TRUNK Is used as the object in the command used 

to define and change the configuration attributes for 
layers 1 and 2 software and the needed hardware to 
support the HDLC line. 

OLD NAME MCI.LINK.ATTRIBUTES 

NEW NAME MCI.TRUNK 

DESCRIPTION MCI.TRUNK is used as the object in the command, used 

to define and change the configuration attributes for 
layers 1 and 2 software and the needed hardware to 
support the mainframe channel interface as a network 
solution or an interface to the C170 network 
products. 

OLD NAME ETHERNET_LINK_ATTRIBUTES 

NEW NAME ESCI.TRUNK 

DESCRIPTION ESCI.TRUNK Is used as the object In the command used 

to define and change the configuration attributes for 
layers 1 and 2 software and the needed hardware to 
support the use of ethernet as a network solution 

OLD NAME LINE 

NEW NAME Same 

DESCRIPTION LINE is used as the object in the commands used to 

define and display the configuration attributes of a 
communication line. This object is also used in the 
commands used to display the status and statistics 
for a given communication line. 

OLD NAME TERMINALJ)EVICE 

NEW NAME TERMINAL 

DESCRIPTION TERMINAL is used as the object in the command used to 

define and display the physical configuration of a 
terminal device* connected to a communication line. 



c 
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4.2.2 OBJECT NAMES FOR SOFTWARE ELEMENTS 



OLD NAME NETWORK_PRODUCTS_INTERFACE 

NEW NAMF C170_INTERFACE 

DESCRIPTION C170.INTERFACE Is used as the object in the command 

used to define the configuration attributes of the 
software used to provide an interface between a 
CDCNET system and the C170 network products. At a 
future time* it may also be used as the object In the 
commands used to display the status and statistics 
for the C170 network products Interface software. 

OLD NAME C170_TRANSPARENT_GATEWAY 

NEW NAME C170_BATCH_GW 

DESCRIPTION CL70.BATCH.GW Is used as the object in the command 

used to define the configuration attributes of the A 
to A gateway between CDCNET and G170 network 
products. At a future time* it may also be used as 
the object in the commands used to display the status 
and statistics for this gateway. 

LD NAME C170_INTERACTIVE_GATEWAY 

NEW NAME C170.IVT.GW 

DESCRIPTION C170_IVT_GW is used as the object in the command used 

to define the configuration attributes of the A to T 
gateway between CDCNET and C170 network products. At 
a future time* it may also 3 be used as the object in 
the commands used to display the status and 
statistics for this gateway. 

OLD NAME PACKET_LEVEL_ATTRIBUTES 

NEW NAME X25.INTERFACE 

DESCRIPTION X25.INTERFACE Is used as the object in the command 

used to define the configuration attributes of the 
X.25 packet level software. At a future time* It may 
also be used as the object In the commands used to 
display the status and statistics for this software 
component. 

OLD NAME X25.TRANSPARENT.GATEWAY 

NEW NAME X25.GW 

DESCRIPTION X25_GW Is used as the object In the command used to 

define the configuration attributes of the gateway 
between CDCNET and an X.25 PDN. At a future time* it 
may also be used as the object in the commands used 
to display the status and statistics for this 
gateway. 



/isj;-.*i'M.'*' , *j6»i* 
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OLD NAME TIP 

NEW NAME Same 

DESCRIPTION TIP is used as the object in the command used to 

define the configuration attributes of the TIP 
software. At a future time* it may also be used as 
the object in the commands used to display the status 
and statistics for this software component. 

OLD NAME DIRECTORY.ATTRIBUTES 

NEW NAME DIRECTORY 

DESCRIPTION DIRECTORY is used as the object in the command used 

to define the configuration attributes of the 
DIRECTORY software. At a future time* it may also be 
used as the object in the commands used to display 
the status and statistics for this software 
component. 

OLD NAME LOG_RETAlN_QUEUE_LIMIT, LOG.PRESERVE.QUEUE.LIMIT 

NEW NAME None 

DESCRIPTION The values of these objects will be hard coded in the 

Dependent LOG M-E code. 

OLD NAME OSA.ATTRIBUTES 

NEW NAME OSA 

DESCRIPTION OSA is used as the object in the command used to 

define the configuration attributes of the Operator 
support application software. At a future time* it 
may also be used as the object in the commands used 
to display the status and statistics for this 
software component.' 

OLD NAME SOFTWARE.MODULE 

NEW NAME None 

DESCRIPTION 



4.2.3 NETWORK AND SYSTEM LEVEL OBJECT NAMES 



OLD NAME SYSTEM.ATTRIBUTES 

NEW NAME SYSTEM 

DESCRIPTION SYSTEM is used as the object in the commands used to 

define and display the configuration attributes of a 

CDCNET system. 

OLD NAME INITIALIZATION.DEFAULTS 




c 
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NEW NAME BOOT_OEFAULTS 

DESCRIPTION This object Is used In the command used to add 

Information In the "exception" file about the default 
load file to be used to load the CDCNET systems not 
Identified In the "exception" file. 

OLD NAME SYSTEM_EXCEPTIONS 

NEW NAME EXCEPTION_SYSTEMS 

DESCRIPTION This object Is used In the command used to add 

Information in the "exception" file about systems 
which should not be loaded from the default load 
file. 

OLD NAME PERIPHERAL.ATTRIBUTES 

NEW NAME CIM.INTERFACE, ESCI_INTERFACE 

DESCRIPTION These object are used in the commands used to define 

the Interface parameters for CIM and ESCI firmware 

and the Device manager. 

OLD NAME COMMUNITY 

NEW NAME COMMUNITY_SEGMENT, COMMUNITY.MEMBERSHIP 

DESCRIPTION This objects are used in the commands used to define 

a CDNA community. 



4.2.4 OPERATOR INTERFACE RELATED OBJECT NAMES 



OLD NAME ALARM.OUTPUT 

NEW NAME None 
DESCRIPTION 

OLD NAME ALARM.HISTORY 

NEW NAME Same 

DESCRIPTION This object is used in the command used to display a 

certain number of previously received alarms at the 

operator's terminal 

OLD NAME CONNECTED.MDI 

NEW NAME None 
DESCRIPTION 

OLD NAME COMMAND MDI 

NEW NAME None 
DESCRIPTION 
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OLD NAME SYNCHRONOUS.MODE 

NEW NAME None 

DESCRIPTION 

OLO NAME ASYNCHRONOUS.MODE 

NEW NAME None 

DESCRIPTION 

OLD NAME COMMAND 

NEW NAME Same 

DESCRIPTION This object is used in the command used by a CDCNET 

operator to send a command to one or more CDCNET 

systems* 

OLD NAME COMMANDJ.OGGING 

NEW NAME None 

DESCRIPTION 

OLD NAME COMMAND_RESPONSE 

NEW NAME RESPONSE 

DESCRIPTION 

DESCRIPTION This object is used in the command used by a CDCNET 

operator to route command responses to. a file. ^~ 

OLD NAME COMHAND.ECHO. ^ 

NEW NAME None 

DESCRIPTION 

OLD NAME OPERATOR.NOTE 

NEW NAME Same 

DESCRIPTION This object is used in the command used by a CDCNET 

operator to add a message in the operator's log. 

OLD NAME OPERAT0R.LOG 

NEW NAME Same 

DESCRIPTION This object is used in the command used by a CDCNET 

operator to display the operator log at the 

operator's terminal. 

OLD NAME DEFAULT.DOMAIN 

NEW NAMF None 

DESCRIPTION 



,1T^ 
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4.2.5 DIAGNOSTICS RELATED OBJECT NAMES 



OLD NAME ERROR_REPORTING_THRESHOLD 

NEW NAME LOGGING.THRESHOLD 

DESCRIPTION This object is used in the commands used to define 

and display the thresholds used for certain events to 
decide if these events should be logged. 

OLD NAME HARDWARE.ELEMENT.STATE 

NEW NAME ELEMENT_STATE 

DESCRIPTION This object is used in the command used to change the 

state {e.g. maintenance) of a hardware element in a 

CDCNET system. 

OLD NAME LINK.TRAFFIC and LINK_TRAFFIC_RATE 

NEW NAME TRAFFIC 

DESCRIPTION This object is used in the command used to change the 

amount of traffic on a given network solution 



Os 



OLD NAME PATH AND PATHS 

EW NAME Same 

DESCRIPTION These objects are used in the command used to test 

and display one or more paths between two CDCNET 

systems. 



OLD NAME DIAGNOSTICS 

NEW NAME XXX_TEST>where XXX represents the element to be 

tested. 
DESCRIPTION These objects are used In the commands used to 

execute diagnostic tests on a hardware element in a 

CDCNET system. 



4.2.6 MISCELLANEOUS OBJECT NAMES 



OLD NAME AUTO.RECOGNITION 

NEW NAME Same 

DESCRIPTION AUTO.RECOGNITION is used as the object in commands 

used to start and stop auto recognition of line 
attr ibuteste.g. speed) by the terminal support 
software. 



C 0L 



D NAME FILE_TYPE AND FILE.TYPES 
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NEW NAME Same 

DESCRIPTION These objects are used In the commands used to define 

and display file types supported by a given 

Independent file access ME* 

OLD NAME STATISTICS 

NEW NAME METRICS 

DESCRIPTION METRICS is used as the object In commands used to 

stop reporting of statistics for one or more CDCNET 

elements. 

OLD NAME STATISTICS.COLLECTION 

NEW NAME METRICS.COLLECTION 

DESCRIPTION METRICS.COLLECTION is used as the object in commands 

used to control the collection of statistics for one 

or more CDCNET elements. 

OLD NAME STATISTICS.PERIODIC.REPORTING 

NEW NAME METRICS.REPORTING 

DESCRIPTION METRICS.REPORTING is used as the object in commands 

used to control the periodic reporting of statistics 

for one or more CDCNET elements. 

OLD NAME SYSTEM.STATISTICS 

NEW NAME SYSTEM.METRICS 

DESCRIPTION SYSTEM_METRICS is used as the object in the command 

used to display the performance statistics for a 

CDCNET system. 

OLD NAME FAILURE.STATISTICS 

NEW NAME FAILURE.METRICS 

DESCRIPTION FAILURE.METRICS is used as the object in the command 

used to display the failure statistics for a CDCNET 

system. 

OLD NAME HARDWARE.STATUS 

NEW NAME Same 

DESCRIPTION HARDWARE.STATUS is used as the object in the command 

used to display the status of one or more hardware 

elements in a given CDCNET system. 

OLD NAME SOFTWARE.STATUS 

NEW NAME Same 

DESCRIPTION SOFTWARE.STATUS is used as the object in the command 

used to display the status of all software components 

in a given CDCNET system. 

OLD NAME DI.STATUS 

NEW NAME SYSTEM. STATUS 



o 



€ 
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DESCRIPTION SYSTEM.STATUS is used as the object In a command used 

to display the status of a CDCNET system. 

OLO NAME TERMINAL.ATTRIBUTES 

NEW NAME Same 

DESCRIPTION This is used as the object name in the commands used 

to define and display the terminal attributes. 

OLD NAME CONNECTION AND CONNECTIONS 

NEW NAME Same 

DESCRIPTION CONNECTION Is used as the object in commands used to 

create or delete a connection or an association for a 
terminal user. CONNECTIONS is used as the object in 
a command used to display all active connections for 
a given terminal user. 

OLD NAME WORKING.CONNECTION 

NEW NAME Same 

DESCRIPTION WORKING.C0NNECTI0N is used as the object in a command 

used to select one of the active connections for a 
terminal user as the working connection. 



aLD N 
EW N 



AME CONNECTION.ATTRIBUTES 

AME Same 

DESCRIPTION CONNECTION.ATTRI8UTES is used as the object in 

commands used to define and display the attributes of 
a terminal user connection or association. 



OLD NAME STRING 

NEW NAME Same 

DESCRIPTION STRING Is used as the object in commands used to 

obtain from or send to a terminal a character string. 

OLD NAME RESOURCE 

NEW NAME None 

DESCRIPTION 

OLD NAME MQOULE 

NEW NAME Same 

DESCRIPTION MODULE is used as the object in commands used to 

load* deload and retain a software component in a 

CDCNET system. 



o 
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4.3 £UiHfi£SJlL^tiE-£flttlliaQJ!AttES 



This section provides a list of current command names and proposed 
new names (If any) based on proposed changes In command verbs and 
objects. The commands are grouped in functional groups. 



4.3.1 NETWORK DEFINITION COMMANDS 



DLDLH111E 



MEH_flAflEII E-&IEEEEEMI1 



SET. 
SET. 
None 
None 
ADD. 
None 
ADD. 
SET. 
SET. 
SET. 
SET. 
SET. 
None 
SET. 
None 
None 
None 
SET. 
SET.! 
SET. 
SET. 
SET. 
SET. 
CONF 
CONF 
CONF 
SET. 
SET. 
SET. 
SET. 
SET. 
SET 



SYSTEM.ATTRIBUTES 
PEPIPHERAL.ATTPIBUTES 



COMMUNITY 

FILE.TYPE 

INITIALIZATION.DEFAULTS 

SYSTEM.EXCEPTIONS 

HDLC.LINK.ATTRIBUTES 

MCI.LINK.ATTRIBUTES 

E THE RNET.L INK. ATTRIBUTES 

NETWORK. SOLUTION.ATTR I BUTES 



X25.NETW0R 

NETWORK.PR 

C170.TRANS 

C170. INTER 

PACKET.LEV 

X25.TRANSP 

IGUPE.TIP 

IGURE.LINE 

IGURE.TERM 

DIRECTORY. 

LOG.RETAIN 

LOG.PRESER 

OSA_ATTPIB 

DVM.ATTRIB 

ERROR.REPO 



K.SOLUTION.ATTRIBUT 

ODUCTS.INTERFACE 

PARENT.GATEWAY 

ACTIVE.GATEWAY 

EL. ATTRIBUTES 

ARENT.GATEWAY 



INAL.DEVICE 

ATTRIBUTES 

.OUEUE.LIMIT 

VE.QUEUE_LIMIT 

UTES 

UTES 

RTING.THRESHOLD 



DEFI 
None 
DEFI 
DEFI 
DEFI 
DEFI 
Same 
SET. 
SET. 
DEFI 
DEFI 
DEFI 
DEFI 
None 
DEFI 
DEFI 
DEFI 
ES DE 
STAR 
STAR 
STAR 
STAR 
STAR 
DEFI 
DEFI 
DEFI 
CHAN 
None 
None 
STAR 
None 
CHAN 



NE.SYSTEM 

NE.CIM.INTERFACE 
NE.ESCI.INTERFACE 
NE.COMMUNITY.SEGMENT 
NE.COMMUNITY.MEMBERSHIP 

BOOT.DEFAULTS 

EXCEPTION.SYSTEMS 

NE.HDLC.TRUNK 

NE.CHANNEL.TRUNK 

NE.ETHER.TRUNK 

NE.X25.TRUNK 

NE.HOLC.NET 

NE.ETHER.NET 

NE.CHANNEL.NET 

FINE.X25.NET 

T.C170.INTERFACE 

T.C170.BATCH.GW 

T C170.IVT.GW 

T.X25.INTERFACE 

T.X25.GW 

NE.TIP 

NE.LINE 

NE.TERMINAL 

GE.DIRECTORY 



T.OSA 
GE.LOGGING.THRESHOLD 



zf \ 
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4.3.2 NETWORK MONITORING COMMANDS 



4.3.2.1 £Qli£I£UiAIIfla-QISEUX-£Qfifl AMDS 



QLa-tuat 



tt£*JiAttEiI£-ai£££!EliIl 




DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
None 
DISPLAY 
None 
None 
None 
None 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
ISPLAY 



.SYSTEM.ATTRIBUTES 
,HDLC_LINK_ATTRIBUTES 
.MCI_LINK_ATTRIBUTES 
.ETHERNET_LINK_ATTRIBUTES 

_NETWORK_SOLUTION_ ATTRIBUTE 



.X25.PACKET.LEVEL. ATTRIBUTE 
.DIRECTORY ATTRIBUTES 
.OSA.ATTRIBUTES 
,DVM_ATTRIBUTES 
.ERROR_REPORTING_THRESHOLO 



DISPLAY 

DISPLAY 

DISPLAY 

DISPLAY 

DISPLAY 

None 

OISPLAY 

DISPLAY 

DISPLAY 

DISPLAY. 

DISPLAY 

DISPLAY 

DISPLAY. 

None 

DISPLAY 



.SYSTEMJ3PTI0NS 

,HDLC_TRUNK_OPTI0NS 

.CHANNEL.TRUNK.OPTIONS 

,ETHER_TRUNK_OPTIONS 

.X25_TRUNK_0PTI0NS 

.HDLC.NET.OPTIONS 

,ETHER_NET_OPTIONS 

,CHANNEL_NET_OPTIONS 

.X25_NET_0PTI0NS 

.X2 5.INTERFACE.OPTI0NS 

.DIRECTORY OPTIONS 

.OSA.OPTIONS 

_LOGGING_THRESHOLD 



4.3.2.2 SIAIUS-4UQ-SIAIISIi£S-CISEUl-£QflflAiinS 



O^ 



QUL.!iltlE 

DISPLAY.SOFTWARE.STATUS 

None 

None 

DISPLAY.FILE.TYPES 

OISPLAY_DI_STATUS 
DISPLAY_HARDWARE_STATUS 
DISPLAY.LINE. STATUS 
None 
DISPLAY_NETWOPK.STATUS 

DISPLAY.PATHS 

DISPLAY.SYSTEM.STATISTICS 

DISPLAY_FAILURE_STATISTICS 

DISPLAY.STATISTICS 

None 

None 

None 



UEH-tl£aEiIE_QI£EE&EiiIl 

Same 

DISPLAY_TRANSPORT_STATUS 
DISPLAY.DIREC TOR Y_ STATUS 
Same 

DISPLAY_SYSTEM_STATUS 



DISPLAY.TR UNK. STATUS 



DISPLAY.SYSTEM.METRICS 

OISPLAY.FAILURE.METRICS 

None 

DISPLAY_LINE_METRICS 

DISPLAY_TRUNK_METRICS 

DISPLAY.NETWORK.METRICS 
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■f 



None 
None 



DISPLAY.TRANSPORT.METRICS 
DIS PL AY.DI RECTOR Y_METRICS 



4.3.3 NETWORK CONTROL COMMANDS 



4.3.3.1 £fltlEI£U&UIQti_£HAU££ JIQflttAlinS 



QLG-MHE 



S£K-8*tt&iIf-aiEEE££fciIl 



CHANGE 

CHANGE 

CHANGE 

None 

CHANGE 

None 

None 

None 

CHANGE 
CHANGE 
CHANGE 
CHANGE 



.HDLC. 
.MCI.L 

ETHER 



LINK.ATTRIBUTES 

INK.ATTRIBUTES 

NET.LINK.ATTRIBUTES 



CHANGE, 

CHANGE 

CHANGE. 

CHANGE, 
.NETWORK.SOLUTION.ATTRIBUTESNone 

CHANGE. 

CHANGE. 

CHANGE. 

CHANGE 
ACKET_LEVEL_ATTRIBUTESCHANGE. 
TORY.ATTRIBUTES CHANGE, 
TTRIBUTES CHANGE. 

M_ATTRIBUTES CHANGE. 



.X25_P 

.DIREC 
.OSA.A 
.SYSTE 



.HDLC.TRUNK 
.CHANNEL.TRUNK 
.ETHER.TRUNK 
.X25.TRUNK 

.HDLC.NET 
.CHANNEL.NET 
.ETHER.NETWORK 
.X25.NET 
.X25.INTERFACE 
.DIRECTORY 
.OSA 
SYSTEM 



V y 



4,3.3.2 HARMA£E-Alin-SaEIllA££-£QlLIRaL-£aiUlAHflS 



ENABLE.LINE 

DELETE.TERMINAL.DEVICE 

DISABLE.LINE 

DELETE.LINE 

ACTIVATE.AUTO.RECOGNITION 

ENABLE.LINK 

ENABLE.NETWORK.SOLUTION 

DISABLE.LINK 

DISABLE NETWORK SOLUTION 

ACTIVATE.SOFTWARE.MODULE 

DEACTIVATE.SOFTWARE.MODULE 

DELETE.COMMUNITY 
None 



U£H-Mtt£iI£-aLE£E£E&Il 



STAR 
DELE 
STOP 
CANC 
STAR 
STAR 
STAR 
STOP 
STOP 
None 
None 



T.LINE 

TE.TERMINAL 

.LINE 

EL.LINE 

T.AUTO.RECOGNITION 

T.TRUNK 

T.NETWORK 

.TRUNK 

.NETWORK 



CANCEL.COMMUNITY.SEGMENT 
CANC EL.COM MUNI TY.MEMBERSHIP 



G 
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4.3.3.3 SIAmU£S-0(iai&aL_£aafi ABQS 



DLQ_^iH£ N.£M-MM£IIE_D.I£E£££N.I1 

ENABLE.STATISTICS.COLLECTION START.METR ICS.COLLECTION 
DISABLE.STATISTICS.COLLECTION STOP.METRICS.COL LECTION 
ENABLE.STATISTICS.PERIODIC.REPORTING 

START.METR ICS.PE PORTING 
DISABL E.STAT ISTICS.PER IOD I C.RE PORTING 

STOP_METRICS_REPORTING 



4.3.3.4 E£SfliiaC^-CDMIEaL.CmittAfclDS- 



nLQ-HAflE UEM_MAttEU£J2IE£E££!iIl 



a 



REQUEST.RESOURCE None 

RELEASE.RESOURCE None 

LOAD.MODULE 

ETAIN.MODULE 

NLOAO. MODULE 



4.3.4 TERMINAL USER INTERFACE COMMANDS 



QU2-MM,£ BElUiAllElIEJlIEEE&ElLn 

DO 

SET_TERMINAL_ATTRIBUTES DEFINE.TER MINAL.ATTRIBUTES 

DISPLAY_TERMINAL_ATTRIBUTES 

None DISPLAY_TEPMINAL_ATTRIBUTE 

CREATE.CONNECTION 

DISPLAY.CONNECTIONS 

SET.WORKING.CONNECTION CHANGE WORKING.CONNECTION 

DELETE.CONNECTION 

SET_CONNECTION_ATTRIBUTES CHANGE.CONNECTION.ATTR IBUTES 

DISPLAY.CONNECTION.ATTRIBUTES 

None DISPLAY.CONNECTION.ATTRIBUTE 

GET.STRING 

PUT.LINE PUT.STRING 

HELP 



o 
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4.3.5 OPERATOR INTERFACE COMMANDS 



SEND.COM 

BROADCAS 

INHIBIT. 

DISPLAY. 

DISPLAY. 

SET.COMM 

SET.SYNC 

SET.ASYN 

EXECUTE. 

ROUTE.CO 

ENABLE.C 

DISABLE. 

ENTER. OP 

DISPLAY. 

QUIT 

ENABLE.C 

DISABLE. 

SET.COMM 

DELETE.C 

SET.DEFA 



MAND 

T.COMMAND 

ALARM.OUTPUT 

ALARM.HISTORY 

CONNECTED.MDI 

AND.MDT 

HRONOUS.MODE 

CHRONOUS.MODE 

COMMAND.FILE 

MMAND.RESPONSE 

OMMAND.ECHO 

COMMAND.ECHO 

ERATOR.NOTE 

0PERAT0R.LOG 

OMMAND.LOGGING 
COMMAND.LOGGING 
AND COMMUNITY 
OMMAND.COMMUNITY 
ULT.OOMAIN 



BEH-HAfl£U£-JiI£EE£E&Il 



CHANGE.COM MAND.ENV I RONMENT 

DISPLAY.COMMANO.ENVIRONMENT 
DEFINE.COM MAND.ENVIRONME NT 
DEFINE.COMMAND.ENVIPONMENT 
DEFINE.COM MAND.ENV IRONMENT 
DO 

ROUTE.RESPONSE 
CHANGE.COMMAND.EN VI RONMENT 
CHANGE.COM MAND.ENV I RONMENT 
ADD.OPERATOR.NOTE 



CHANGE.COM MAND.ENVI RONMENT 
CHANGE.COMMAND.ENVI RONMENT 
CHANGE.COM MAND.ENVI RONMENT 
CHANGE.COM MAND.ENV IRONMENT 
DEFINE.COMMAND.ENV I RONMENT 



4.3.6 FAILURE MANAGEMENT COMMANDS 



aL£____£ 




BEH-HAHEilE-filEEERttill 


CHANGE.HARDWARE_ELEMENT.ST ATE 


CHAN GE.ELEMENT.S TATE 


CHANGE LINK TRAFFIC 




CHANGE.TRAFFIC 


CHANGE.LINK.TRAFFIC. 


.RATE 


CHANGE TRAFFIC 


CHECK.PATH 




START.PATH.TEST 


ECHO 




START.PATH.TEST 


None 




STOP.PATH.TEST 


LOOPBACK.LOCAL 




START_LOCAL.LOOPBACK.TEST 


LOOPBACK.REMOTE 




START.REMOTE.LOOPBACK.TEST 


None 




STOP.LOCAL.LOOPBACK.TEST 


None 




STOP.REMOTE_LOOPBACK.TEST 


EXEC.UTE.DIAGNOSTICS 




None 


None 




START.MPB.TEST 


None 




START.CHANNEL.TEST 


None 




START.ESCI.TEST 


None 




START_CIM_TEST 


None 




START_SMM_TEST 



4" X'- 
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None START.LIM.TEST 

None START_PORT_TEST 

None STOP_MPB_TEST 

None STOP_CHANNEl_TEST 

None STOPJESCI.TEST 

None STOP_CIM_TEST 

None STOP_SMM_TEST 

None STOPJ.IM.TEST 

None START_PORT_TEST 

TERMINATE_DIAGNOSTICS None 

ADD.DIAGNOSTIC.TRAFFIC CHANGE.TRAFFIC 



o 
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5 . UQSI3L&_S£1.JEIALAB£U A££-iULES 



The Information In this section has been extracted from the NOS/VE 
Command Writer's Guide* 

5.1 METALANGUAGE RULES 

1. The symbol :s» is read as "is defined to be". 

2. The symbol ! is read as "or" and elements separated by it are 
mutually exclusive. 

3. Elements enclosed by < > constitute a single element In 
relation to surrounding metalanguage symbols. 

4. Elements enclosed by t 1 are optional and constitute a single 
element in relation to surrounding metalanguage symbols. 

5. Elements followed by ... may be repeated. When the ... 
follows a > or 1. the ••• applies to the metalanguage text 
between and including the matching < or C. 

6. Underlined characters are to be Interpreted literally in a 
metalanguage definition (e.g. •*£" means the character "< H » not 
the metasymbol "<*'). An underline character by itself (e.g. 
_) means Itself (as opposed to meaning the space character). 

7. Names which appear in a metalanguage definition in upper case 
letters have. In the context in which they appear* special 
meaning to SCL. When using such names in actual SCL text, 
lower case letters may be used interchangabl y with the 
corresponding upper case letters. 

8. The notation <the ascii xxxxx> Is used to denote a particular 
(non-graphic) character in the ASCII (American Standard Code 
for Information Interchange) character set (xxxxx describes the 
character in question). 

9. The notation <any ascii character except xxxxx) is used to 
denote any ASCII character except the character(s) specified by 
xxxxx. 

10. The notation (xxxxx expression) is used to denote a expression 
of type xxxxx. 



o 



( 



( 



J 
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11. The notation <xxxxx functlon> is used to denote a function that 
returns a value of type xxxxx. 

12. The notation <xxxxx command> is used to denote the command 
named xxxxx* 

13. The notation <xxxxx name> is used to denote a name that 
designates a xxxxx. 

14. The notation (xxxxx variabie> Is used to denote a variable of 
type xxxxx. 

15. The notation <ascii> is used to designate any ASCII character. 

16. The notation (beginning of line> is used to designate the 
beginning of a. command line. 

17. The notation <end of line> is used to designate the end of a 
command i ine. 

18. The notation <eol> is used to designate the end of information 
on a f I I e. 

19. The notation <eop> is used to designate the end of a partition 
on a file. 

20. The notation <empty> is used to designate an enpty (null) 
syntactic construct. 



o 
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5.1 USE_Q£.S£A£ES 

Spaces may In general be used to separate other SCL elements from 
each other In order to improve readability. Also* SCL permits spaces to 
be used as separators between parameters and between the elements of a 
list. Wherever spaces may appear* comments may also be used. 

<sp> ss* <spaces ! comment>... 

<spaces J comment> ss* <spaces> J <comment> 

<spaces>. ss* <space>... 

<space> ss* <the ascii space character SP> 

* <the ascii horizontal tab character HT> 

Because of their use as separators* it is necessary to impose 
restrictions on where spaces can occur. For instance* spaces are not 
permitted between the component parts of a file or variable reference. 



5.2 Q£LIttUERS 

The following definitions are for delimiters used throughout SCL for 
various purposes. The definitions illustrate whether spaces (see 
previous section) preceding or following the actual delimiter are 
considered to be a part of the delimiter. 

Delimiters other than those below are used in SCL for various 
purposes but only for those shown below is the use of surrounding spaces 
consistent throughout. 

<»!spJnl> ss* <,> J < S p> I <nl> 

<spjnl> ss* <sp> ! <nl> 

< ; I n I > ss* < s > { <nl> 

<nl> ss* <eol> <bol> C<eol> <bol>1... 

<bol> ss* <beginning of line> t<sp>3 
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CONVENTIONS AND GUIDELINES FOR CDCNET COMMANDS 



5.0 NOS/VE SCL METALANGUAGE RULES 
5.2 DELIMITERS 



<eol> ::= t<sp>] <end of line) 
<t !sp> s:« <>> ! <sp> 



<$> : 
<J> « 
<:> s 
<(> s 
<)> : 



- r<sp>] t c<sp>] 

- [<sp>i ; t<sp>] 
* : 

= ( C<sp>] 

» C<sp>3 > 

■ . 

i* £<sp>3 <•><•> [<•>!... t<sp>3 



o 



o 



V. 



l f--\ 

1> 



